home *** CD-ROM | disk | FTP | other *** search
/ Exame Informatica 140 / Exame Informatica 140.iso / Programas / Zsnes / docs / readme.txt / advanced.txt < prev    next >
Encoding:
Text File  |  2006-12-21  |  16.0 KB  |  439 lines

  1. ZSNES v1.50
  2.  
  3. ================================
  4.     N a v i g a t i o n
  5. ================================
  6.  
  7.     * Index    [Index.txt]
  8.  
  9.     * Readme    [Readme.txt]
  10.  
  11.     * GUI    [GUI.txt]
  12.  
  13.     * Netplay    [Netplay.txt]
  14.  
  15.     * Advanced Usage    [Advanced.txt]
  16.         1. Movie Dumping
  17.         2. Configuration Files
  18.         3. Debugger
  19.         4. Command-Line
  20.  
  21.     * Games    [Games.txt]
  22.  
  23.     * FAQ    [FAQ.txt]
  24.  
  25.     - - - - - - - - - - - - - - - - - -
  26.  
  27.     * Getting Support    [Support.txt]
  28.  
  29.     * History    [History.txt]
  30.  
  31.     * About    [About.txt]
  32.  
  33.     * License    [License.txt]
  34.  
  35.     - - - - - - - - - - - - - - - - - -
  36.  
  37.     * NSRT Guide:    [http://zsnes-docs.sf.net/nsrt]
  38.  
  39.     * ZSNES Home Page:  [ZSNES.com]
  40.  
  41.  
  42. ================================================================================
  43. ~                         A d v a n c e d    U s a g e
  44. ================================================================================
  45.  
  46. This page documents the advanced features of ZSNES, probably not useful for most
  47. end users.
  48.  
  49.  
  50. ............................................................
  51.   1.                   Movie Dumping
  52. ............................................................
  53.  
  54. Please note that ZSNES does not support real-time video encoding. ZSNES only
  55. encodes existing ZMV (ZSNES movie) files. Refer to the GUI page [GUI.txt] for
  56. instructions on recording movies.
  57.  
  58. All instructions in this section assume that you are using the default settings
  59. of the zmovie.cfg file. If you are smart enough to edit zmovie.cfg, you had
  60. better be smart enough to dump movies with whatever new settings you've created.
  61.  
  62. You can dump video output alone, audio output alone, both at the same time (to
  63. separate files), or both to the same file (merged). If you choose to dump audio
  64. output, you can choose to dump that audio output uncompressed or compressed to
  65. MP3. Both uncompressed and compressed audio can be merged with the video.
  66.  
  67. - - - - - - - - - - - -
  68.  About Video Encoding
  69. - - - - - - - - - - - -
  70.  
  71. Video encoding requires MEncoder [http://www.mplayerhq.hu].
  72.  
  73. - - - - - - - - - - - -
  74.  About Audio Encoding
  75. - - - - - - - - - - - -
  76.  
  77. Audio encoding requires LAME [http://lame.sourceforge.net]. Currently, Windows
  78. users *must* use this fixed LAME build [http://nsrt.edgeemu.com/lame.zip] due to
  79. a bug in the official versions.
  80.  
  81. You have a choice of dumping audio either in uncompressed PCM format with WAV
  82. header, or compressed as MP3. ZSNES uses LAME [http://lame.sourceforge.net] for
  83. MP3, so you can expect high-quality audio, given the bit rate.
  84.  
  85. When dumping audio to a separate file (not merged with video), audio compressed
  86. to MP3 will be about 6% of the size of the same uncompressed PCM audio.
  87.  
  88. - - - - - - - - -
  89.  Dumping a Movie
  90. - - - - - - - - -
  91.  
  92.   1. Place your MEncoder (mencoder.exe) and LAME (lame.exe) binaries in the same
  93.      directory as ZSNES. Alternatively, configure your PATH environment variable
  94.      to include the directories where MEncoder and LAME are installed.
  95.   2. Start ZSNES and load a game.
  96.   3. Open the Movie Options dialog. (Misc Menu->Movie Opn).
  97.   4. Make sure to select the correct movie slot, depending on which movie slot
  98.      you used to record a ZMV.
  99.   5. Configure the Dump Video and Dump Audio options to your liking.
  100.   6. Hit the Dump Movie button.
  101.   7. ZSNES will then exit the GUI and start playing back the previously recorded
  102.      movie. If you chose to encode the video and/or audio output, you will see a
  103.      console window appear, showing the progress of encoding. Don't worry if
  104.      ZSNES slows down while playing back the movie; it needs to do this because
  105.      the encoding process takes a lot of processor time.
  106.   8. ZSNES will indicate when the movie has finished playback (and encoding).
  107.      You can now look in your ZSNES directory for the newly created file(s).
  108.  
  109. Note: ZSNES does not create an uncompressed temporary file and then encode it.
  110.   Instead, the output stream is directly encoded. The only output files will be
  111.   the finished, compressed files. Because ZSNES must encode the output stream as
  112.   it is generated, ZSNES may delay the output of new frames of video/audio to
  113.   give more time to MEncoder/LAME to compress the current frame. This means that
  114.   you should *not* worry if you see the playback of your movie slow down while
  115.   ZSNES is dumping it. The dumped file(s) will play back at full speed!
  116.  
  117.  
  118. ............................................................
  119.   2.                Configuration Files
  120. ............................................................
  121.  
  122. Every time you run ZSNES, it checks to see if these files are present in the
  123. same directory as the ZSNES executable. If they are not, ZSNES will create them
  124. with their default values. Thus, if you are having weird problems with ZSNES,
  125. try deleting these files.
  126.  
  127. If there are any missing or invalid lines in zsnes*.cfg, ZSNES will insert or
  128. replace the lines with their default values.
  129.  
  130. - - - - - - -
  131.  zsnes*.cfg
  132. - - - - - - -
  133.  
  134. Almost every option available in ZSNES can be configured in this file. If there
  135. is something you don't understand in this file, please refrain from changing it,
  136. and instead set the option from within the ZSNES GUI [GUI.txt].
  137.  
  138. The last letter of the filename is different for each port.
  139. Windows: zsnesw.cfg    SDL: zsnesl.cfg    DOS: zsnes.cfg.
  140.  
  141. - - - - - - -
  142.  zmovie.cfg
  143. - - - - - - -
  144.  
  145. This file contains movie-dumping configuration information.
  146.  
  147. You can edit this file to make ZSNES use something other than MEncoder or LAME,
  148. or to tweak options. Read the MEncoder and LAME manuals to see what options you
  149. can tweak. If you choose other applications, they must support stream input via
  150. stdin and raw video (in the case of video encoding). Refer to the appropriate
  151. documentation for more information.
  152.  
  153. Unfortunately, you're on your own if wish to play with this.
  154.  
  155. - - - - - - -
  156.   zfont.txt
  157. - - - - - - -
  158.  
  159. This file contains the font data for the ZSNES GUI. You can edit this file to
  160. customize the font.
  161.  
  162.   * Comments are preceded by a ; and can be up to 99 characters in length.
  163.       - In the default file, each comment precedes the character it's labeling.
  164.   * Each letter is represented by a block of five rows, each containing 8 bits.
  165.     Only the first five columns of bits are used for font data; ZSNES uses a 5x5
  166.     font. The last three columns of bits should always be zeros.
  167.       - There are characters for English, Hiragana, and Katakana scripts.
  168.   * In case it isn't obvious, a 1 means the pixel is on in that location. A 0
  169.     means it's off. If you view zfont.txt, you should be able to figure it out.
  170.   * The file terminates on the EOF+newline character or the last character
  171.     (whichever comes first).
  172.  
  173. The absolute ordering of each and every line in this file is *important*. If
  174. you're missing a single line, things might start messing up. Just so you know,
  175. the last line of data should be on line 846, followed by the EOF character on
  176. line 847.
  177.  
  178. If you mess something up, just delete zfont.txt, and ZSNES will re-generate it
  179. as normal.
  180.  
  181.  
  182. ............................................................
  183.   3.                      Debugger
  184. ............................................................
  185.  
  186. The debugger, now available in all ports, is enabled only when you enter ZSNES
  187. with a -d (If you are using the DOS port, just type "zsnes -d" at the
  188. commandline. Win port users should add a "-d" after their ZSNES shortcut
  189. target).
  190.  
  191. Average users, however, should have no need to use the debugger.
  192.  
  193. - - - - - - - - - - - - - - - -
  194.  .   . Debugger  .  Keys .   .
  195. - - - - - - - - - - - - - - - -
  196.  
  197. |Key|  |Function|
  198. - - - - - - - - -
  199.  1      Enable/Disable SPC700 display
  200.  2      Enable/Disable 65816 display
  201.  T      Trace (in 65816 opcodes)
  202.  B      65816 break point
  203.  S      SPC break point
  204.  C      Clear counter
  205.  M      65816 modify
  206.  A      SPC modify
  207.  D      Debug dump (SPC/DSPRAM dump only)
  208.  W      Break at signal (used only by the programmers)
  209.  F1     Exit debugger and return to game
  210.  F2     Save state
  211.  F4     Load state
  212.  Esc    Exit entire program
  213.  
  214.  
  215. ............................................................
  216.   4.               Command-Line Arguments
  217. ............................................................
  218.  
  219. ZSNES supports execution arguments via the command line. More detailed
  220. descriptions of how to use the arguments with each port is forthcoming.
  221.  
  222. Further detail of each argument's effect is given in [GUI.txt] for the
  223. corresponding GUI option, if one exists.
  224.  
  225.   Usage : zsnes* [-d,-f #, ... ] filename.sfc
  226. Example : zsnes* -s -r 2 game.sfc
  227.  
  228. *Fill in the appropriate letter for your port when entering this into the
  229. command line.
  230.  
  231.  
  232. - - - - - - - - - - - - - - - -
  233.  . .  Universal  Switches  . .
  234. - - - - - - - - - - - - - - - -
  235. Argument|Sub-Arg.|Description
  236. = = = = = = = = = = = = = = =
  237. -1 #/-2 #         Select Player 1/2 Input
  238.           0         None
  239.           1         Keyboard
  240. -d                Start with debugger enabled
  241. -dd               Disable sound SPC700/DSP emulation, which also disables sound
  242.                   output
  243. -dh               Disable ROM-specific hacks
  244. -ds               Disable sound output
  245. -f #   [0...9]    Enable fixed frame rate
  246. -g #   [0...15]   Specify gamma correction value
  247. -h                Force HiROM
  248. -j                Disable Mouse (Automatically turns off right mouse click)
  249. -k #   [0...100]  Set Volume Level
  250. -l                Force LoROM
  251. -m                Disable GUI (Must specify ROM filename)
  252. -mc               Exit ZSNES when closing a movie (use with -zm)
  253. -md #             Dump video (use with -zm)
  254.           1         Raw
  255.           2         FFV1
  256.           3         x264
  257.           4         XviD
  258.           5         Custom
  259. -n #              Enable scanlines (when available)
  260.           0         None
  261.           1         Full
  262.           2         25%
  263.           3         50%
  264. -o                Disable MMX support
  265. -p #  [50...150]  Percentage of instructions to execute
  266. -r #              Set sound sampling rate
  267.           0         8000Hz
  268.           1         11025Hz
  269.           2         22050Hz
  270.           3         44100Hz
  271.           4         16000Hz
  272.           5         32000Hz
  273.           6         48000Hz
  274. -s                Enable sound output and enable SPC700/DSP emulation
  275. -sa               Show all extensions in GUI (*.*)
  276. -t                Force NTSC timing
  277. -u                Force PAL timing
  278. -v8               Grayscale mode
  279. -y                Enable Interpolation graphics filter
  280. -z                Disable stereo sound
  281. -zm #  [0...9]    Auto load specified movie slot on startup
  282. -zs #  [0...99]   Auto load specified save state slot on startup
  283.  
  284.  
  285. - - - - - - - - - - - - - - - -
  286.  . . Windows-only Switches . .
  287. - - - - - - - - - - - - - - - -
  288. From the Windows NT command-line, you can use the following command to view the
  289. accepted command-line input for a given ZSNES binary: "zsnesw -? | more".
  290. Typing "zsnesw -?" does not work.
  291.  
  292. Users of any flavor of Windows can use the following command to output to a file
  293. the same information returned from the command above: "zsnesw -? > commands.txt"
  294.  
  295. Argument|Sub-Arg.|Description
  296. = = = = = = = = = = = = = = =
  297. -3                Enable triple buffering (disables VSync)
  298. -6 #  [50...180]  Force a user-specified refresh rate for fullscreen modes
  299. -js # [0...32767] Set joystick sensitivity
  300. -kp               Enable the KitchenSync for PAL only (100Hz)
  301. -ks               Enable the KitchenSync for NTSC and PAL (120Hz/100Hz)
  302. -v #              Select Video Mode:
  303.           0         256x224 R WIN
  304.           1         256x224 R FULL
  305.           2         512x448 R WIN
  306.           3         512x448 DR WIN
  307.           4         640x480 S WIN
  308.           5         640x480 DS WIN
  309.           6         640x480 DR FULL
  310.           7         640x480 DS FULL
  311.           8         640x480 S FULL
  312.           9         768x672 R WIN
  313.           10        768x672 DR WIN
  314.           11        800x600 S WIN
  315.           12        800x600 DS WIN
  316.           13        800x600 S FULL
  317.           14        800x600 DR FULL
  318.           15        800x600 DS FULL
  319.           16        1024x768 S WIN
  320.           17        1024x768 DS WIN
  321.           18        1024x768 S FULL
  322.           19        1024x768 DR FULL
  323.           20        1024x768 DS FULL
  324.           21        1024x896 R WIN
  325.           22        1024x896 DR WIN
  326.           23        1280x960 S WIN
  327.           24        1280x960 DS WIN
  328.           25        1280x960 S FULL
  329.           26        1280x960 DR FULL
  330.           27        1280x960 DS FULL
  331.           28        1280x1024 S WIN
  332.           29        1280x1024 DS WIN
  333.           30        1280x1024 S FULL
  334.           31        1280x1024 DR FULL
  335.           32        1280x1024 DS FULL
  336.           33        1600x1200 S WIN
  337.           34        1600x1200 DS WIN
  338.           35        1600x1200 DR FULL
  339.           36        1600x1200 DS FULL
  340.           37        CUSTOM D WIN
  341.           38        CUSTOM DS FULL
  342.           39        CUSTOM WIN
  343.           40        CUSTOM S FULL
  344.           41        CUSTOM DR FULL
  345. -w                Enable VSync (disables triple buffering)
  346.  
  347.  
  348. - - - - - - - - - - - - - - - -
  349.  . . . SDL-only Switches . . .
  350. - - - - - - - - - - - - - - - -
  351. Argument|Sub-Arg.|Description
  352. = = = = = = = = = = = = = = =
  353. -js # [0...32767] Set joystick sensitivity
  354. -v #              Select Video Mode:
  355.           0         256x224 R WIN
  356.           1         256x224 R FULL
  357.           2         512x448 DR WIN
  358.           3         512x448 DR FULL
  359.           4         640x480 DR FULL
  360.           5         256x224 OR WIN
  361.           6         512x448 ODR WIN
  362.           7         640x480 ODS FULL
  363.           8         640x480 ODS WIN
  364.           9         640x560 ODR WIN
  365.           10        768x672 ODR WIN
  366.           11        800x600 ODS FULL
  367.           12        800x600 ODS WIN
  368.           13        896x784 ODR WIN
  369.           14        1024x768 ODS FULL
  370.           15        1024x768 ODS WIN
  371.           16        1024x896 ODR WIN
  372.           17        1280x960 ODS FULL
  373.           18        1280x1024 ODS FULL
  374.           19        1600x1200 ODS FULL
  375.           20        VARIABLE ODR WIN
  376.           21        VARIABLE ODS WIN
  377.           22        CUSTOM OD FULL
  378.  
  379.  
  380. - - - - - - - - - - - - - - - -
  381.  . . . DOS-only Switches . . .
  382. - - - - - - - - - - - - - - - -
  383. Argument|Sub-Arg.|Description
  384. = = = = = = = = = = = = = = =
  385. -0                Force black background in 8-bit modes
  386. -1 #/-2 #         Select Player 1/2 Input:
  387.           2         2 Button
  388.           3         4 Button
  389.           4         6 Button
  390.           5         8 Button
  391.           6         Sidewinder #1
  392.           7         Sidewinder #2
  393.           8         Sidewinder #3
  394.           9         Sidewinder #4
  395.           10        Gamepad Pro #0
  396.           11        Gamepad Pro #1
  397.           12        LPT1 #1
  398.           13        LPT1 #2
  399.           14        LPT1 #3
  400.           15        LPT1 #4
  401.           16        LPT1 #5
  402. -3                Enable triple buffering (disables VSync)
  403. -8                Force 8-bit sound
  404. -c                Enable full/wide screen (when available)
  405. -cc               Enable small screen (when available)
  406. -sp               Report sound detection information
  407. -v #              Select Video Mode:
  408.           0         256x224x8B (MODEQ)
  409.           1         256x240x8B (MODEQ)
  410.           2         256x256x8B (MODEQ)
  411.           3         320x224x8B (MODEX)
  412.           4         320x240x8B (MODEX)
  413.           5         320x256x8B (MODEX)
  414.           6         640x480x16B (VESA1)*
  415.           7         320x240x8B (VESA2)
  416.           8         320x240x16B (VESA2)
  417.           9         320x480x8B (VESA2)
  418.           10        320x480x16B (VESA2)
  419.           11        512x384x8B (VESA2)
  420.           12        512x384x16B (VESA2)
  421.           13        640x400x8B (VESA2)
  422.           14        640x400x16B (VESA2)
  423.           15        640x480x8B (VESA2)
  424.           16        640x480x16B (VESA2)
  425.           17        800x600x8B (VESA2)
  426.           18        800x600x16B (VESA2)
  427. -w                Enable VSync (disables triple buffering)
  428.  
  429. *The 640x480x16B (VESA1) video mode is compatible with many video cards, but can
  430.   also be very slow. We recommend that you use a VESA2 mode if your video card
  431.   supports it. Please see the system requirements for more information
  432.   [Readme.txt].
  433.  
  434.  
  435. . . . . . . . . . . . . . . . .
  436. This documentation is best viewed in a fixed-width font such as "Courier New".
  437.  
  438. Copyright (C) ZSNES Team & ZSNES Documentation Team [License.txt]
  439.